home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Online / Epic4 / share / epic / help / 2_queries / names < prev    next >
Text File  |  2001-03-21  |  2KB  |  52 lines
  1. Synopsis:
  2.    names [<switch> [<arg>] [<switch> [<arg>] ...]] [<channel>]
  3.  
  4. Description:
  5.    NAMES returns a list of users on the specified channel.  The user list
  6.    will include a + or @ prepended to those nicks that are +v or +o in
  7.    that channel, respectively.
  8.  
  9.    If an exact channel name is given, only information about that channel
  10.    is returned.  If a '*' is used as the channel name, the current
  11.    channel is used.  Otherwise, the client will request a NAMES listing
  12.    for all known channels.
  13.  
  14.    The client can search for specific channels or channels with certain
  15.    characteristics.  If a glob pattern is given for the channel name, all
  16.    channels matching that pattern are shown.  The list can be limited to
  17.    channels with only a certain number of users, or those that are private
  18.    or public.  Multiple switches may be used at once.
  19.  
  20.    NAMES output is affected by channel modes.  If a channel has mode +p,
  21.    then its name will be masked in the output.  However, it can still be
  22.    displayed normally if the exact channel name is known.  If the channel
  23.    has mode +s, then it will not appear in any NAMES output, whether the
  24.    exact name is known or not.  These limitations only apply to users not
  25.    on the channels in question (i.e. a user on a +s channel can use NAMES
  26.    for that channel normally).
  27.  
  28. Options:
  29.    -min <n>   shows channels with no less than n users
  30.    -max <n>   shows channels with no more than n users
  31.    -public    shows public channels only
  32.    -private   shows private channels only
  33.    -all       overrides any previous -public or -private switch
  34.                 
  35. Examples:
  36.    To show users on all channels with 3 to 15 users:
  37.       /names -min 3 -max 15
  38.  
  39.    To show users on public channels with "help" in the name:
  40.       /names -public #*help*
  41.  
  42. See Also:
  43.    on(5) names
  44.  
  45. Other Notes:
  46.    Unless a specific channel name is given, the client will send a NAMES
  47.    request for all channels and filter the output locally.  This is worth
  48.    noting because large networks can easily have upwards of 2,000 channels
  49.    at any given moment.  Parse such a large list will greatly slow the
  50.    client.
  51.  
  52.